Endpoint Profiles

Route

/v2/endpoint-management/profiles

Description

List existing endpoint management profiles or create new profiles with applied configurations and targeting rules.

Methods

• GET — list all profiles
• POST — create a profile

Inputs (POST)

Parameter	Type	Required	Description
name	string	Yes	Unique profile name
description	string	No	Optional description
type	ProfileType	Yes	Profile type (endpoint_sensor, etc.)
priority	integer	Yes	Priority for application
applied_configurations	AppliedProfileConfigurations	Yes	Configuration modules applied to the profile
uninstall_enabled	boolean	No	Allow remote uninstall
targeting	Targeting	Yes	Targeting rules (e.g., CEL expression)
override_configuration	object	No	Additional JSON overrides

Request Example (POST)

{
  "name": "Secure Laptops",
  "description": "Profile for corporate macOS laptops",
  "type": "endpoint_sensor",
  "priority": 150,
  "applied_configurations": {
    "performance_configuration": "config-performance",
    "detection_configuration": "config-detection"
  },
  "uninstall_enabled": false,
  "targeting": {
    "type": "cel",
    "query": "device.os == \"macos\" && device.is_corporate"
  }
}

Output (GET/POST)

Field	Type	Description
type	string	Always "profiles"
size	integer	Number of profiles returned
resources	array[Profile]	Profile objects
errors	array[Error]	Any errors

Profile Object (key fields)

Field	Type	Description
id	string	Profile identifier
name	string	Profile name
description	string	Description
is_default	boolean	Default profile flag
type	string	Profile type
status	string	Profile status
applied_configurations	AppliedProfileConfigurations	Attached configuration modules
uninstall_enabled	boolean	Remote uninstall allowed
priority	integer	Priority for targeting
targeting	Targeting	Targeting rules
override_configuration	object	Additional JSON overrides

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response (GET)

{
  "type": "profiles",
  "size": 1,
  "resources": [
    {
      "id": "profile-secure-laptops",
      "name": "Secure Laptops",
      "description": "Profile for corporate macOS laptops",
      "type": "endpoint_sensor",
      "status": "active",
      "applied_configurations": {
        "performance_configuration": "config-performance",
        "detection_configuration": "config-detection"
      },
      "uninstall_enabled": false,
      "priority": 150,
      "targeting": {
        "type": "cel",
        "query": "device.os == \"macos\" && device.is_corporate"
      }
    }
  ],
  "errors": []
}